home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / cvt2qb12.zip / TAG-ACF.DOC < prev    next >
Text File  |  1993-03-09  |  14KB  |  254 lines
  1.                             Interfacing TAG to AcFiles
  2.  
  3. Kudos
  4. ~~~~
  5.  
  6.                 TAG     Copyright The TAG Team (Hey that's new!)
  7.                 AcFiles Copyright Ray Cole
  8.  
  9.                 Thanks go out to The  TAG team for providing the structures
  10.                 necessary for  creating  this  and  other  TAG  utilities.
  11.                 Special  thanks  to  Victor  Capton  and  Paul Williams for
  12.                 providing special  insight  into  some  of TAG's innards,
  13.                 thus making it much easier to provide this interface.
  14.  
  15.                 Thanks go to Ray Cole as well for this truly remarkable
  16.                 file  door. AcFiles is probably the most intuitive, powerful
  17.                 and flexible file  systems  in  existence. It defiantly the
  18.                 file system for both users and sysops.
  19.  
  20. Whadda I need?
  21. ~~~~~~~~~~~~~~
  22. You will find all the programs needed to operate Acfiles with  TAG  in  the
  23. files  CVT2QB??.ZIP  and ACF?????.??? (Meaning the most current versions of
  24. both ACFILES and CVTQBBS).
  25.  
  26. The conversion programs needed  to  setup  and  maintain the necessary QBBS
  27. V2.7? files are:
  28.  
  29.     CVT2QBBS.EXE        : Generates the main QBBS System Files
  30.     EXITINFO.EXE        : Generates the ExitInfo.BBS and DorInfo?.Def Files
  31.     SETDLK  .EXE        : Allows Sysop Configurable Daily Download  K
  32.                           restrictions By Security Level
  33.     ADDFILE .EXE        : Adds Files Uploaded to ACFILES from the QBBS List
  34.                           Files created by CVT2TAG (Nightly event)
  35.  
  36. See each of these utilities' documentation for operational details.
  37.  
  38.  
  39. I  am not going to go into a whole lot of detail on the actual setup.. If you
  40. can't read and understand the AcFiles docs then you really should not attempt
  41. to set the program up. I will, however, describe a few of the things that are
  42. pertinent to setting up with TAG  and  some  of the things I have discovered
  43. that one should or should not do.
  44.  
  45. First:
  46.  
  47. Setup your AcFiles directory and unzip  all  the  related  files  into  this
  48. directory. AcFiles is multi-node aware and if you plan to run in a multi-node
  49. configuration  make sure you have setup a separate AcFiles data directory for
  50. each node. And you will  need  to  follow the multi-node instructions for the
  51. CVT2QBBS utilities as well. Failure  to  do  so  will  produce  unpredictable
  52. result at best. (If you want  to use DLK restrictions Execute SETDLK before
  53. You Run CVT2QBBS)
  54.  
  55. Once  you  have  created  the  needed  directories  and  placed  the  various
  56. conversion files and data files  where  described  with  in the docs, Run The
  57. program CVT2QBBS in each  of  the  AcFiles  node  directories  (the  CVT2QBBS
  58. program  MUST  be  in  the respective directories), This will create the QBBS
  59. system files and the List files (normally Files.Bbs but, if you are running a
  60. CD-ROM, the list file name and path could well be different).
  61.  
  62. Now that we have created our  QBBS  system run the AcFiles conversion program
  63. for QBBS systems called QBBS2ACF.EXE.. provide it with the path to your  QBBS
  64. system node directory.
  65.  
  66. Now run the AcFConf.EXE program. The details for Configuring AcFiles can be
  67. found in the Sysop Documentation. here are some highlights:
  68.  
  69. -[RUN ACFIDX After ACFCFG and  only  run it ONCE! all extended descriptions
  70.   will be *Lost* if you run ACFIDX after initial setup!]-
  71.  
  72.  
  73. ▐▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▌
  74. ▐ (N)ame: Area 1                                              Area #: 1      ▌
  75. ▐────────────────────────────────────────────────────────────────────────────▌
  76. ▐ (P)ath       : C:\NEWFILES\                                                ▌
  77. ▐ (F)ILES.BBS  : C:\NEWFILES\FILES.BBS                                       ▌
  78. ▐  Data(B)ase   : AF-1                                                       ▌
  79. ▐ (D)escription: ]-=(New File Uploads)=-[                                    ▌
  80. ▐─────────────────────┬───────────────────────────┬──────────────────────────▌
  81. ▐ (1) Area Sec: 10    │ (2) Download Sec: 100     │ (3) Upload Sec: 100      ▌
  82. ▐                     │                           │                          ▌
  83. ▐     AX-------       │       AX-------           │     AX-------            ▌
  84. ▐     B--------       │       B--------           │     B--------            ▌
  85. ▐     C--------       │       C--------           │     C--------            ▌
  86. ▐     D--------       │       D--------           │     D--------            ▌
  87. ▐                     │                           │                          ▌
  88. ▐ PW:                 │   PW:                     │ PW:                      ▌
  89. ▐─────────────────────┴───────────────────────────┴──────────────────────────▌
  90. ▐ (4) Free Area  : No      (6) Dupe Check: Yes      (8) Allow NewScan: Yes   ▌
  91. ▐ (5) Upload Area: 1       (7) Area Type : Public   (9) Days to Keep : 0     ▌
  92. ▐────────────────────────────────────────────────────────────────────────────▌
  93. ▐ [+/-] - Next/Previous      [G] - Global Changes      [R] - Remove Area     ▌
  94. ▐ [</>] - Next Defined Area  [J] - Jump to Area                              ▌
  95. ▐                            [M,C] - Move/Copy Area                          ▌
  96. ▐▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  97.  
  98. It's important to note options 5 and  9..  Option 5 allows you to specify a
  99. file area other than the download file area for uploads. This is  important
  100. for  those  of  you running CD-ROMS and single area uploading. If you use a
  101. single new file upload area  I  would  suggest  you use the [G]lobal Changes
  102. option for setting all your file areas at once. As you  can  see  there  is
  103. even  a provision for file area passwords just like TAG. Also Note that the
  104. days to Keep will cause AcFiles  to  remove  old files from the file system
  105. when they are older than the days entered in option (9).. so READ the  docs
  106. carefully!  (This  will  not  remove  the  files from TAG at this time so I
  107. wouldn't recommend removing them from  Acfiles with this automatic option at
  108. this time.)
  109.  
  110. Most of this information will already be filled in for you via the CVT2QBBS
  111. and QBBS2ACF program.. but you may need to come here for fine tuning.
  112.  
  113. Next Look at the general configuration....
  114.  
  115.  
  116.  
  117. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ General Editor ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  118. ▌1)             BBS Name:  The Best BBS In The World Running ACF            ▐
  119. ▌2)           SysOp Name:  Great SysOp                                      ▐
  120. ▌3)             BBS Path:  C:\BBS\                                          ▐
  121. ▌4)  Extended Desc. Path:  C:\ACFILES\DESC\                                 ▐
  122. ▌5)  External Msg Editor:                                                   ▐
  123. ▌6)   "UL By" Sec. Level:  0                                                ▐
  124. ▌7)     SysOp Sec. Level:  64000                                            ▐
  125. ▌8)   Inactivity Timeout:  360                                              ▐
  126. ▌9)    Upload Time Ratio:  1                                                ▐
  127. ▌A) UL Drive Space Check:  3000                                             ▐
  128. ▌B)      Free Download K:  200                                              ▐
  129. ▌C)         Display Mode:  DIRECT                                           ▐
  130. ▌D) Hide U/Ls by Default:  NO                                               ▐
  131. ▌E)    Menu Twirl Prompt:  ON                                               ▐
  132. ▌F) On-Line Count Update:  ON                                               ▐
  133. ▌G)    Area Change Style:  Matrix                                           ▐
  134. ▌H) Forced Pre-U/L Info.:  None                                             ▐
  135. ▌I)    User/Local Length:  Vary                                             ▐
  136. ▌J)      Starting Screen:  Area Change                                      ▐
  137. ▌K)      Auto-D/L File 1:                                                   ▐
  138. ▌L)          File 1 Desc:                                                   ▐
  139. ▌M)      Auto-D/L File 2:                                                   ▐
  140. ▌N)          File 2 Desc:                                                   ▐
  141. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  142.  
  143. Some important notes here are Options G, H,J, C, B, 7, 6, 9, and  F.  Do
  144. NOT  activate  Option  F..  This  will  generate  a  bastard version of the
  145. files.bbs and will not allow ADDFILE to import properly.
  146.  
  147. Make sure you set Option 7 to 255 or you will not have access to any of the
  148. Acfiles sysop functions online.
  149.  
  150. If you allow extended descriptions  you  MUST define an external editor and
  151. create the description path. Another side affect is that if you  don't  use
  152. acfiles to delete the file then the description files will remain until you
  153. manually find and erase them. If there appears to be a need, I will write a
  154. utility  that  removes files from TAG based upon their existence within the
  155. list file (files.bbs) but I personally  think  this would be better left to
  156. manual.. at least for now.
  157.  
  158. I recommend using option (G) in it's template mode. This means that  a  user
  159. could  have  a  security  level  high  enough to see a section but not high
  160. enough to access it. Kinda like  TAG's read/write message base security, Or
  161. privileged S/L for files areas.
  162.  
  163. I recommend Option (J) be set to files menu.. this means AcFiles will place
  164. the use in the firs file area they have access to and present them with the
  165. main operations menu.
  166.  
  167. Option (H) should be set to ask For Description and Name...  This  requires
  168. the  user  to enter the file name and description before uploading.. and it
  169. will also allow for  a  new  scan  prior  to uploading. AcFiles will notice
  170. unlisted uploads and will also prompt the user for the description to these
  171. files.  (Side note.. Acfiles can also be easily set up to work with TAGSCAN
  172. as well although there isn't really a need for it as you will find once you
  173. see all the internal post-upload functions possible with AcFiles)
  174.  
  175. Option (D) Hide Uploads Means that until you "UnHide" them they will not be
  176. added to the Files.BBS. this is the same as Utilizing TAG's Validation.
  177.  
  178.  
  179. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Node Editor ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  180. ▌ A) ACFiles Data Path: .\                                                  ▐
  181. ▌ B)     Log File Name: acfiles.log                                         ▐
  182. ▌ C)       Node Number: 4                                                   ▐
  183. ▌ D)      Paging Hours: 00:00-23:59                                         ▐
  184. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  185.  
  186. Selection:
  187.  
  188. The Node Editor is  self  explanatory  and  should  be utilized as per the
  189. AcFiles Sysop Documentation. (sorry but anything this good takes a  bit  of
  190. setup and learning.)
  191.  
  192. Maintenance
  193. ~~~~~~~~~~~
  194. yor nightly maintenance should include  running ADDFILE.EXE, CVT2QBBS for
  195. each TAG node,and running  and  ACF_UTIL.EXE...  and  they should  be
  196. executed in that order! this insures that all files uploaded by either TAG
  197. or AcFiles will end up in both file systems. Don't forget to run ACF_UTIL
  198. with the /MAINT option  or  all  of  your  files will appear to be offline
  199. to users entering the door (after new list  files  are  created  by
  200. CVT2QBBS.EXE). ]-=(DON'T RUN ACFIDX as a nightly Event!)=-[
  201.  
  202. Read  the  AcFiles  documentation section on creating an input file for the
  203. ACF_UTIL /MAINT function.. it makes it much simpler.
  204.  
  205. Acfiles also comes with a provision  for coverting archive types.. This can
  206. also be done while moving files from area to area so please  pay  attention
  207. to the docs in this regard.
  208.  
  209. If you elect to have AcFiles  create  your file listings (for download) for
  210. you via the ACF_UTIL /MASTER option you may  need  to  understand  how  the
  211. flags are converted from TAG to QBBS:
  212.  
  213.     TAG - QBBS Flags diagram
  214.     ~~~~~~~~~~~~~~~~~~~~~~~~
  215.  
  216.         A Flags = @ A B C D E F G
  217.         B Flags = H I J K L M N O
  218.         C Flags = P Q R S T U V W
  219.         D Flags = X Y Z _ _ _ _ _
  220.         E Flags = _ _ _ _ _ _ _ _
  221.  
  222.          So a User with the G and B AR flags would have a QBBS a flag setup
  223.         that  looks  like: X_X____X. If you had an area with an access flag
  224.         restriction of Z and  you  didn't  want  this included in your file
  225.         listing and you only wanted areas with a DSL allowance of 100  then
  226.         your command line would be:
  227.  
  228.             ACF_UTIL /MASTER SEC_100 FLAGD?_??????
  229.  
  230.         Using the S/L and Flags (as well as ranges) you can easily create
  231.         file lists consisting of any specific areas you desire.. Normal and
  232.         adult areas for example (I told you this thing does it all)
  233.  
  234.  
  235. BIG NOTE!
  236. ~~~~~~~~~
  237.  
  238. Since  QBBS  offers  *much*  higher security levels, and the sysop security
  239. default is 64000, you will  need  to  completely reconfigure the Sysop menu
  240. keys! Write down each key  and  it's  function  (see  the  Keys  menu,  sysop
  241. functions),  then  delete  and re-add them ONE AT A TIME making sure you set
  242. the S/L to the appropriate level  (you  can  offer some of the keys to your
  243. file area Co-Ops is you wish).
  244.  
  245. This should be all I need to tell you at this  point..  If  there  are  any
  246. questions  or comments (especially with the Beta CVT2QBBS files) contact me
  247. via Netmail at 1:236/16... This is the preferable way but if you cannot for
  248. some reason or another then I can be reached via the TAGBETA, TAG, TAGDOORS
  249. echos or call my BBS at (219) 747- 5871.
  250.  
  251. Rick Cooper
  252.  
  253.  
  254.